利用Hexo+Github 搭建博客

沐成尘 3月 07, 2018

万事开头难，第一次总是让人既困惑又欣喜。踏出第一步，远比空想有意义的多。

始建之初

搭建博客的想法来自于一个朋友的鼓舞，谨以本文来记念这次“美好的旅程”。本人利用Github+Hexo来搭建了这个博客，在此过程中无论是环境搭建还是功能配置都占据了我不少的时间，踩中了不少坑，希望本文能做个好的开始，并记录下中过程中遇到的相关问题。

准备工作

下载node.js，npm 并安装。
下载git。

在Ubuntu下可以打开终端输入：

sudo apt-get install nodejs npm git

使用Arch Linux用户可以输入：

pacman -S nodejs npm git

sudo yaourt -S node js npm git

值得一提的是，如果你的Linux在安装npm 时出现依赖问题

Windows 用户可自行搜索安装。

检查安装

在终端下，输入 node -v ， npm -v ，git –version
如果都成功显示版本号，则说明安装正确，可以进行下一步操作了，如果不正确，请回头检查安装过程。

在本地搭建hexo博客

新建一个文件夹，自定义文件夹的名称，如 Blog。
在命令行中输入：

npm install hexo-cli -g

回车后会出现WARN，不用担心不会影响使用。
接下在你就会看到命令行窗口刷下了一大堆白字，下面我们来看一看Hexo是不是已经安装成功了。在命令行中输入：

hexo -v

如果成功显示Hexo的版本信息并且识别成功了你的本地计算机配置，则说明已经安装成功了。

初始化Hexo

成功安装Hexo后，进入刚才新建的文件夹 Blog，在命令行中输入：

hexo init

紧接着输入：

npm install

之后npm将自动安装所需要的组件，这需要点时间，耐心等一会哦。
当组件安装完成后，连续输入两行指令：

hexo g
hexo s

然后会提示一行指令：

INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

在浏览器中打开这个链接：http://localhost:4000/，成功显示Hexo的默认模板。
到目前为止，Hexo在本地的配置已经全都结束了。

将本地博客与Github关联

在Github上创建名字为xxx.github.io的项目，XXX是自己GIthub的用户名。
打开本地的Blog文件夹内的_config.yml 配置文件，将其中的type设置为git，并且在repository： 后写上自己Github的项目地址。

deploy:
type: git
repository: https://github.com/MiniFullC/MiniFullC.github.io.git
branch: master

保存后运行：npm install hexo-deployer-git –save
运行：hexo g （生成本地静态文件）
运行：hexo d （将本地静态文件推送到Github上）
此时hexo将会自动将本地的文件向github提交请求，接下来就会让你输入你github上的帐号和密码，输入正确后就会开始同步。

查看自己的博客

上面你已经在github上按照规范输入了博客地址，xxx.github.io，这就是你的主页啦，基本的配置和上传已经成功了，接下来就来写一篇自己的博文吧！

新建文章

打开Hexo目录，找到source文件夹，所有的文章都会以Markdown形式保存在_post文件夹中。
好了知道了文章的存储地点那么如何快速的新建一个文章呢？
在Hexo站点目录下右键打开命令行，输入

hexo new “***”

***是你自定义文章的名字我们发现站点根目录下的source文件夹中的 _post 文件夹中多了一个XXX.md的文件，使用Markdown编辑器打开

---
title: hello-world   //在此处添加你的标题。
date: 2014-11-7 08:55:29   //在此处输入你编辑这篇文章的时间。
categories: Exercise   //在此处输入这篇文章的分类。
toc: true  
---
//在此处输入这篇文章的内容。

保存后，运行命令hexo g就可以进行渲染了。

结语

完成了以上所有的步骤后，一个基础简单的博客就搭建成功了！